home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglprioritizetextures.z / fglprioritizetextures
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss((((3333GGGG))))      OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss - set texture residence priority
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss( INTEGER*4 _n,
  14.                                        CHARACTER*8 _t_e_x_t_u_r_e_s,
  15.                                        CHARACTER*8 _p_r_i_o_r_i_t_i_e_s )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _n           Specifies the number of textures to be prioritized.
  20.  
  21.      _t_e_x_t_u_r_e_s    Specifies an array containing the names of the textures to be
  22.                  prioritized.
  23.  
  24.      _p_r_i_o_r_i_t_i_e_s  Specifies an array containing the texture priorities.  A
  25.                  priority given in an element of _p_r_i_o_r_i_t_i_e_s applies to the
  26.                  texture named by the corresponding element of _t_e_x_t_u_r_e_s.
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss assigns the _n texture priorities given in
  30.      _p_r_i_o_r_i_t_i_e_s to the _n textures named in _t_e_x_t_u_r_e_s.
  31.  
  32.      The GL establishes a ``working set'' of textures that are resident in
  33.      texture memory.  These textures may be bound to a texture target much
  34.      more efficiently than textures that are not resident.  By specifying a
  35.      priority for each texture, ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss allows applications to
  36.      guide the GL implementation in determining which textures should be
  37.      resident.
  38.  
  39.      The priorities given in _p_r_i_o_r_i_t_i_e_s are clamped to the range [0, 1] before
  40.      being assigned.  0 indicates the lowest priority; textures with priority
  41.      zero are least likely to be resident.  1 indicates the highest priority;
  42.      textures with priority one are most likely to be resident.  However,
  43.      textures are not guaranteed to be resident until they are used.
  44.  
  45.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss silently ignores attempts to prioritize texture 0,
  46.      or any texture name that does not correspond to an existing texture.
  47.  
  48.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss does not require that any of the textures named by
  49.      _t_e_x_t_u_r_e_s be bound to a texture target.  ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr may also be used
  50.      to set a texture's priority, but only if the texture is currently bound.
  51.      This is the only way to set the priority of a default texture.
  52.  
  53.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss is included in display lists.
  54.  
  55. NNNNOOOOTTTTEEEESSSS
  56.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss is available only if the GL version is 1.1 or
  57.      greater.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss((((3333GGGG))))      OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss((((3333GGGG))))
  71.  
  72.  
  73.  
  74. EEEERRRRRRRROOOORRRRSSSS
  75.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _n is negative.
  76.  
  77.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss is executed
  78.      between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  79.      ffffggggllllEEEEnnnndddd.
  80.  
  81. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  82.      ffffggggllllGGGGeeeettttTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr with parameter name GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____PPPPRRRRIIIIOOOORRRRIIIITTTTYYYY retrieves the
  83.      priority of a currently bound texture.
  84.  
  85. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.      ffffggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnntttt, ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee, ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD,
  87.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.